home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / games / pyro11.zip / TECHINFO.DOC < prev    next >
Text File  |  1990-11-30  |  13KB  |  289 lines
  1. PYRO 2.2                                                  Technical Information
  2.  
  3.                          #############################
  4.                          ##                         ##
  5.                          ##     TROUBLESHOOTING     ##
  6.                          ##                         ##
  7.                          #############################
  8.  
  9.  
  10. Following is a list of the most common problems, with solutions.  If you cannot
  11. solve a problem using this list, refer to the descriptions of all the command
  12. line switches below.  Remember that command line switches are case-sensitive.
  13.  
  14. PROBLEM:   Pyro hangs on the title screen.
  15. SOLUTION:  Your computer is giving incorrect joystick detection results.
  16.        Type 'PYRO22 -j' to disable the joystick.
  17.  
  18. PROBLEM:   The screen shakes or is off-center.
  19. SOLUTION:  Pyro is attempting to use a video mode which your monitor does not
  20.            support.  Type 'PYRO22 -g' to disable graphics.
  21.  
  22. PROBLEM:   Characters on the screen are blinking.
  23. SOLUTION:  Pyro was unable to reprogram the colors on your video adapter.
  24.            Type 'PYRO22 -n' to disable the extended color set.
  25.  
  26. PROBLEM:   Pyro makes a squealing or buzzing sound.
  27. SOLUTION:  Pyro's sound techniques are not compatible with your computer.
  28.            Type 'PYRO22 -s' to disable sound.
  29.  
  30. PROBLEM:   Computer is not fully IBM-compatible.
  31. SOLUTION:  Type 'PYRO22 -H'.
  32.  
  33.  
  34.                          #############################
  35.                          ##                         ##
  36.                          ##  COMMAND LINE SWITCHES  ##
  37.                          ##                         ##
  38.                          #############################
  39.  
  40.  
  41. BASIC SWITCHES        ADVANCED SWITCHES    COMBINATION SWITCHES
  42. ==============        =================    ====================
  43. -c  Copyright Notice    -z# No Speed Testing    -M  Monochrome
  44. -i  Instructions    -w  Show Speed Test    -H  No Hardware Access
  45. -I  Instructions Mode   -a# Set Video Adapter   -T  Troubleshooting Mode
  46. -o  Olympic Scoring    -v# Set Video Mode      -W# Microsoft Windows Mode
  47. -b  Black & White    -n  Normal Background    -D  DesqView Mode
  48. -b# Black & White Mode  -d  Use DOS/BIOS I/O
  49. -s  Disable Sound    -f  Disable Fading
  50. -j  Disable Joystick    -g  Disable Graphics
  51. -k  Pyro 2.1 Keys
  52.  
  53.  
  54. USING COMMAND LINE SWITCHES
  55. ===========================
  56.  
  57. Keep the following rules in mind when using command line switches:
  58.  
  59. -   Command line switches are case-sensitive.  'PYRO22 -i' is not the same as
  60.     'PYRO22 -I'.
  61.  
  62. -   Command line switches can be grouped together in the following ways:
  63.     Good:    PYRO22 -s -j -d -a2
  64.     Good:    PYRO22 -sjd -a2
  65.     BAD:    PYRO22 -s-j-d-a2
  66.  
  67.  
  68. ALPHABETICAL LIST OF SWITCH DESCRIPTIONS
  69. ========================================
  70.  
  71. -a#    Set Video Adapter
  72. Every time you run Pyro, it runs through a series of tests to determine what
  73. type of video adapter is active in your system.  Sometimes these tests can
  74. produce incorrect results.  In such a case, use the '-a#' switch, with one
  75. of the following numbers in place of '#', to disable the adapter tests:
  76.                 1 = MDPA (Monochrome)
  77.                 2 = CGA  (Color)
  78.                 3 = EGA  (Enhanced Color)
  79.                 4 = MCGA (PS/2 Enhanced Color)
  80.                 5 = VGA  (Analog Color)
  81.  
  82. -b#    Black & White Mode
  83. Tells Pyro to translate on-screen colors to those required by black & white
  84. monitors.  This command line switch affects only colors, not the way in
  85. which Pyro addresses your video adapter.  Use one of the following values in
  86. place of '#':
  87.         0 = Standard Black & White
  88.         1 = Bright Black & White
  89.         2 = IBM PS/2 with Black & White Monitor
  90.         3 = Monochrome Monitor (default when '-a1' used)
  91.         4 = Microsoft Windows 2.x in Window (default when '-W2' used)
  92.                 5 = Full Color, but Brighter
  93. Note: '-b' is the same as '-b0'.
  94.  
  95. -c    Copyright Notice
  96. Displays the copyright (but not the license) information.  Read the interactive
  97. instructions for complete license information (see '-i').
  98.  
  99. -d    Use DOS/BIOS I/O
  100. Pyro normally accesses the screen by writing directly to video memory and your
  101. video adapter's registers.  This command line switch tells Pyro to use the
  102. DOS and BIOS interfaces instead, sacrificing speed for portability.
  103.  
  104. -D    DesqView Mode
  105. Using the '-D' combination switch, Pyro will be able to run in a window
  106. under DesqView 2.x.  Tell DesqView to use this switch on the command line.  Also
  107. tell it that Pyro does not directly access the keyboard or monitor, and that
  108. Pyro needs 140k of conventional memory.  This command line switch is a
  109. combination of the following:
  110.         -d  Use DOS/BIOS I/O
  111.         -f  Disable Fading
  112.         -g  Disable Graphics
  113.         -n  Normal Background
  114. If other command line switches are used that conflict with '-D', the other
  115. switches will override parts of '-D'.
  116.  
  117. -f    Disable Fading
  118. When Pyro detects a VGA adapter, it uses advanced palette changing techniques
  119. to simulate smooth fading.  This command line switch tells Pyro not to change
  120. the palette at all, even if it detects a VGA adapter.
  121.  
  122. -g    Disable Graphics
  123. When Pyro detects a VGA adapter, it directly programs the adapter to enter an
  124. undocumented 320x400 pixel video mode.  It then dynamically changes your
  125. character set to simulate high-resolution graphics and new fonts.  This command
  126. line switch tells Pyro not to enter the undocumented mode or reprogram the
  127. character set, even if it detects a VGA adapter.
  128.  
  129. -H    No Hardware Access
  130. Using the '-H' combination switch, Pyro should be able to run on a computer
  131. that is MS-DOS compatible but not 100% IBM-compatible.  This command line
  132. switch is a combination of the following:
  133.                 -a3 Assume EGA Adapter
  134.         -d  Use DOS/BIOS I/O
  135.         -s  Disable Sound
  136.         -j  Disable Joystick
  137.         -f  Disable Fading
  138.         -g  Disable Graphics
  139.         -n  Normal Background
  140.         -z1 No Speed Test -- Assume Slow Computer
  141. In addition, '-H' disables some of Pyro's program integrity checking.  If
  142. other command line switches are used that conflict with '-H', the other
  143. switches will override parts of '-H'.  For example, '-z0 -H' tells Pyro not to
  144. directly access any hardware, but to assume that you are using a fast computer
  145. instead of a slow one.
  146.  
  147. -i    Instructions
  148. When this switch is used, Pyro will display its interactive instructions,
  149. just as if you were playing Pyro for the first time.
  150.  
  151. -I    Instructions Mode
  152. This switch sets Pyro into the instructions mode.  The next time that Pyro is
  153. run after this switch has been used, Pyro will display its interactive
  154. instructions, just as if you were playing Pyro for the first time.
  155.  
  156. -j    Disable Joystick
  157. This switch tells Pyro to act as if no joystick is connected, even if one is.
  158. Some computers return random joystick information even when no joystick is
  159. connected.  This can cause Pyro to hang or interfere with play.  The '-j'
  160. switch can fix this problem.
  161.  
  162. -k    Pyro 2.1 Keys
  163. This switch tells Pyro to use Pyro 2.1 keys instead of Pyro 2.2 keys when
  164. applicable, thus making the transition to Pyro 2.2 easier for Pyro 2.1 players.
  165.  
  166. -M    Monochrome
  167. Using the '-M' combination switch, Pyro can now run on a computer with an
  168. active MDPA or HGC video adapter.  This was not possible in versions of Pyro
  169. prior to 2.2.  This switch is a combination of the following:
  170.         -a1 MDPA/HGC Adapter
  171.         -b3 Monochrome Monitor
  172.         -f  Disable Fading
  173.         -g  Disable Graphics
  174. If other command line switches are used that conflict with '-M', the other
  175. switches will override parts of '-M'.
  176.  
  177. -n    Normal Background
  178. By detecting the type of video adapter you are using and then directly
  179. programming it, Pyro is able to use sixteen background colors (or attributes)
  180. instead of the standard eight.  However, it is possible that Pyro will
  181. incorrectly identify your adapter, or that you will set your adapter
  182. incorrectly with the '-a#' switch.  In this case, parts of your screen will
  183. blink and use the wrong colors.  To fix the problem, use the '-n' switch.  This
  184. switch tells Pyro not to program your adapter to use sixteen background colors
  185. and to limit itself to the eight background colors that were used in versions
  186. of Pyro prior to 2.2.
  187.  
  188. -o    Olympic Scoring
  189. This command line switch tells Pyro to rate the aesthetic value of your
  190. pyrotechnics, on a scale of 0 through 10, at the end of each floor.  This
  191. "Olympic-style" score does not affect your overall game score in any way.
  192. Even so, it can be fun and challenging to try for a perfect 10.
  193.  
  194. -s    Disable Sound
  195. Pyro uses extremely advanced techniques to provide realistic fire and
  196. explosion sounds through an IBM-compatible's limited sound system.
  197. Unfortunately, a very small minority of computers are unable to handle these
  198. techniques without producing a buzzing or squealing sound.  On these computers,
  199. it is necessary to completely disable sound with the '-s' directive.  Note:
  200. on computers that are compatible with Pyro's sound techniques, sound effects
  201. can be toggled on and off during gameplay by using the [ALT]-[S] command if
  202. you don't use the '-s' switch.
  203.  
  204. -T    Troubleshooting Mode
  205. The '-T' combination switch disables everything Pyro does that is unusual,
  206. advanced, or undocumented.  If Pyro does not work on your computer, use the
  207. '-T' switch (possibly in combination with other switches -- see below).  If it
  208. still does not work, then there is no hope of getting Pyro to work with your
  209. computer.  If it does work, then experiment with combinations of the other
  210. switches described below until you isolate the feature or features of Pyro that
  211. are incompatible with your computer.  The '-T' switch is a combination of the
  212. following:
  213.         -j  Disable Joystick
  214.         -f  Disable Fading
  215.         -g  Disable Graphics
  216.         -n  Normal Background
  217. In addition, '-T' disables some of Pyro's program integrity checking.  Here
  218. are some examples of using the '-T' switch:
  219.         Pyro22 -T        Troubleshoot on a 100% IBM compatible
  220.         Pyro22 -T -H        Troubleshoot on an MS-DOS compatible
  221.         Pyro22 -T -H -a1    Troubleshoot on a monochrome MS-DOS
  222.                     compatible
  223.  
  224. -v#    Set Video Mode
  225. Pyro normally selects video mode 1 on a color adapter and 7 on a monochrome
  226. adapter.  Using this switch, you can force Pyro to use a different video mode.
  227. For example, '-v3' tells Pyro to use mode 3, the 80 column color mode.  '-v'
  228. with no number following it tells Pyro to use the mode you are currently in.
  229. You can even tell Pyro to use proprietary modes that only your video card
  230. supports, and Pyro will adapt itself to them.  For example, if you have an
  231. ATI VGA Wonder, '-v51' tells Pyro to use the 132x43 color mode.  If you choose
  232. to use a graphics mode, you must also use '-n' and '-d'.
  233.  
  234. -w    Show Speed Test
  235. Whenever you run Pyro, it checks the speed of your computer and video adapter
  236. to determine how fast it will be able to write to the screen.  Based on this
  237. information, it may choose not to run some of its fancy introductions.  This
  238. command line switch shows you what speed rating Pyro is assigning your
  239. computer.  (A 4.77 MHz AT-compatible with a good video adapter would earn a
  240. rating of about 12.)  To override the speed test, use the '-z#' switch.
  241.  
  242. -W#     Microsoft Windows mode
  243. Using this switch, Pyro can run in a window under Microsoft Windows 2.x
  244. or, with a 386, Microsoft Windows 3.x.  Tell Windows to use either the '-W2'
  245. switch (for Windows 2.x) or the '-W3' switch (for Windows 3.x) on the command
  246. line.  Also tell it that Pyro does not directly access the keyboard, and that
  247. it requires 140k of conventional memory.  If you are using Windows 2.x (with
  248. the '-W2' switch), tell it that Pyro does not directly access the screen
  249. either.  The '-W#' switch is a combination switch.  Using '-W3' is equivalent
  250. to all of the following:
  251.         -f  Disable Fading
  252.         -g  Disable Graphics
  253.         -n  Normal Background
  254.         -s  Disable Sound
  255. Using '-W2' is equivalent to all of the above plus the following:
  256.         -d  Use DOS/BIOS I/O
  257.         -b4 Microsoft Windows 2.x black & white attribute set
  258. If other command line switches are used that conflict with '-W#', the other
  259. switches will override parts of '-W#'.  Note that the '-W#' switch is not
  260. necessary to run Pyro full-screen under Windows.  An icon is provided for
  261. Windows 3.x users: PYRO22.ICO.
  262.  
  263. -z#    No Speed Testing
  264. Whenever you run Pyro, it checks the speed of your computer and video adapter
  265. to determine how fast it will be able to write to the screen.  Based on this
  266. information, it may choose not to run some of its fancy introductions.  This
  267. command line switch lets you override the speed test with one of the following
  268. values:
  269.         0   Assume extremely fast computer
  270.         1   Assume extremely slow computer
  271. When '-z0' is used, fancy introductions will always be shown.  When '-z1' is
  272. used, they will never be shown.  Note that '-z' is the same as '-z0'.
  273.  
  274.  
  275.                          #############################
  276.                          ##                         ##
  277.                          ##   SOFTWARE DEVELOPERS   ##
  278.                          ##                         ##
  279.                          #############################
  280.  
  281.  
  282. A full range of support is available for both programmers and non-programmers
  283. interested in creating new scenarios, expanding Pyro, or porting it to another
  284. platform.  If you would like more information, or if you have concerns about
  285. the development of future versions of Pyro, please write to:
  286.  
  287.                 Michael O'Brien
  288.                 P.O. Box 14109
  289.                 Santa Barbara, CA 93107